home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #2
/
Monster Media No. 2 (Monster Media)(1994).ISO
/
bbs_util
/
shop180.zip
/
SHOP.UK
< prev
next >
Wrap
Text File
|
1994-08-07
|
29KB
|
705 lines
*────────────────────────────────────────────────────────────────────────────*
* >>>>> The Shop-Door v1.80 <<<<< *
* *
* ShopDoor: A BBS Door for sponsors etc. *
* -------------------------------------------------------------------------- *
* *
* Another SHAREWARE program written by A.S. Kerkmeester !!! *
* *
* (C) 1994 Copyright by: Simplesoft Developments *
* *
*────────────────────────────────────────────────────────────────────────────*
Updates
═══════
You can Freq updates of SHOPDOOR with the Magic-Name 'SHOPDOOR',
but you can also download it from the Official Distribution-Site's:
Arthur Kerkmeester Sergio Creimer
TECHNO SUPPORT BBS Horizontes BBS
The Netherlands Brazil
Phone: 31-1177-2946 Phone: 55312812925 (6 lines)
24hr Online 24hr Online
300 - 16800 Baud HST/DS 2400 - 14400 Baud
FIDO 2:285/421 FIDO 4:803/0
SIGnet 27:6331/110
SWBnet 45:112/0
SHNnet 8:31/0
Mike Foedisch Frank Durstewitz
Nily-Box Leipzig ECHO BBS
Germany Germany
Phone: 49-341-4119079 Phone: 49-7052-3681
24hr Online 24hr Online
2400 - 14400 Baud 2400 - 14400 Baud
SWBnet 45:220/0 SWBnet 45:221/0
CF-Net 38:4904/0 CF-Net 38:49/0
SHNnet 8:4904/0
Mariano Urquiza
ICS link
Argentina
Phone: 54-1-375-4770 (6 lines)
24hr Online
2400 - 14400 Baud
FIDO 4:900/333
What is SHOPDOOR
════════════════
The ShopDoor is a unique Door on it's own, no door like this
has been made yet.
It is in fact a configurable menu-program
but running as a BBS-Door.
Sometimes you want to know (as a Sysop) if certain screens on your
BBS are being watched and also how many times and by which persons.
With this Door you will know all that.
Shopdoor gives you the possibilities to show 1 Mainmenu and 4 Submenus.
(which can contain all 10 screens)
Questions and orders can be made by the users of the Shopdoor.
They will be put in the message-database of the BBS-system.
Also it's possible to download a predefined file (like a pricelist).
The ShopDoor also has a DBASE-IV-compatible database with
various possibilities !
This package contains a complete example, which fully works after extraction.
To see how Shopdoor works. just install it in your BBS
using the manual. Run the Door in your BBS.
You will see, you will like it !
An Example
══════════
Imagine you have a sponsor, who gives you sometimes
some Hardware and more, to help you with your BBS-Hobby.
Because of this sponsoring you have some screens on your BBS
with 'advertisments' from your sponsor.
It's would be nice if you and your sponsor know which screens
are being watched.
For yourself it's useful because you will know if somebody is
looking at the 'advertisments'-screens and it's also useful for your
sponsor because he can look in the information,
created and send by the ShopDoor, and decide if it's (or not) time to
create new 'advertisments'-screens with better, newer and cheaper products.
The possibilities of the ShopManager
════════════════════════════════════
A mouse-supported program with online-help,
which has the following possibilities:
1) To configure The ShopDoor, look further in this document.
2) Viewing the file named 'SHOP.CFG'.
3) Viewing the file named 'SHOP.LOG'.
4) To create some statistical info from the information
from the different echomail-messages created by all
installed versions of the ShopDoor.
5) Database generation.
6) Database Pricelist-generation.
The possibilities of the ShopDoor
═════════════════════════════════
1) Configurable by the ShopManager.
2) Setup to a maximum of 50 different ASCII/ANSI/AVATAR/RIP-screens.
3) Those screens will be divided in 1 Mainmenu and maximum
4 Submenus (maximum 10 screens each menu).
4) In the Mainmenu there are the following standard options:
- Post a message to eg: the Firm.
- A order-menu.
- A download-option of 1 file, eg: a pricelist,
the name of this file is: 'shoplst.arj'.
The echo-areas, where these messages will be written
(one for the orders and one for the questions),
can be put in the SHOP.CFG File.
In doing so, those messages can be send by the normal
echomail-system (mailer/tosser) to the firm (your sponsor).
Every BBS connected to use the same Door
(of the same sponsor), will see all the orders, messages and
statistics in these echo-areas.
5) All the actions taken by the users on the BBS with the ShopDoor are being
registrated and as a log-message sent in the same type of echo-area
as mentioned in point 4.
6) The total of all the actions mentioned in point 4 and 5 are written
in a file named 'SHOP.CFG'.
7) The logging as mentioned by point 4 and 5 is written in a
file named 'SHOP.LOG'.
8) Database support with various nice functions.
9) Also the logfile from the BBS will be updated.
The ShopDoor-Database
═════════════════════
Introduction
────────────
The ShopDoor-package offers the user a DBase-IV-compatible database:
- The various products the ShopDoor user has to offer
can be put in this database.
- With each product it's possible to put the salesprice, 3 different
buying-prices, the warranty-period and the product-description
in these database. The stock-amount of products from each product
can be put in the database but also tax and used valuta.
- The database-files of the ShopDoor can be read with every
DBase-IV-compatible database-program.
- In the ShopDoor there are 2 database-functions available:
the Memo-type and the Picklist-type, both are using
database-screens (or: template-screens).
File-mentioning
───────────────
A database-screen of the ShopDoor has a few files inclosed :
- The database-screen itself : 'DBF???.ANS' .
- The database-textfile : 'DBF???.TXT' .
- The database-file : 'DBF???.DBF' and 'DBF???.DBT' .
For the '???' you must fill in 3 numbers, you may use '000' til '999'.
It's possible to create up to a maximum of 1000 database-screens with
inclosed database-files and database-textfiles.
So as you can see, only the extensions of the various files are
different !
Database-functions
──────────────────
The Memo-type offers the possibility to show e.g. PC-Systems
of the database to the BBS-user. A BBS-user can run through
the database with some keys and e.g. look at these PC-Systems.
The Memo-type shows 1 database-record each time on the screen.
The Picklist-type offers the possibility to show e.g. a collection
of CD-Rom's to the BBS-user. A BBS-user can also run through
the database with some keys and e.g. look at these CD-Rom collection.
The Picklist-type shows a maximum of 12 database-records each time on
the screen.
A BBS-user can, using these database-functions, select the articles
he wants to order with a key. In the order-menu (look further)
he can complete his order.
A further explanation about the database-functions will be found
somewhere else in this manual.
The database-screens displaying these database-functions are predefined,
but it's possible to change those screens a little to give them
the own 'firm-look'.
One of the advantages of these database-functions is
that it's less work to keep the database uptodate instead of updating
the screens each time with the latest information.
With this ShopDoor-package you will have a nice example of both
database-functions. It will make things quite clear by
looking at this example !
Creating a database-screen
──────────────────────────
These database-screens (or template-screens) can be made
in the 4 known formats: ANSI,ASCII,AVATAR and RIP.
If you want to create a database-screen it's a good idea to
copy the file 'DBF001.ANS' for a Memo-type from the example,
and change it to your own desire. It's the same for a Picklist-type,
but using the file 'DBF002.ANS' as an example.
These screens can be made/changed by every screen-editor.
Creating a database
───────────────────
The database-files 'DBF???.DBF' and 'DBF???.DBT' can be made with the
ShopManager. For each database you must create a specific text-file first.
This text-file can be made by a text-editor following a specific structure.
How this must be done will be explained now.
Creating a text-file
────────────────────
It's a good idea to study the examples of the ShopDoor with
the next explanation at hand.
- Global and local Keywords and the '@'-sign :
We use keywords to enter various things in the database.
There are global and local keywords. Each keyword starts always
with the '@'-sign on the beginning of a line. After the '@'-sign the
keyword follows written in text-characters. A database-record will always
be closed with the '@'-sign, but without any character following it !
A local keyword has only effect on the database-record where it's
stand by. A global keyword has effect on all records following it,
but it can be used frequently to give e.g. records different taxes.
- The structure of a database text-file :
* keyword @TAX = optional
* keyword @VALUTA = optional
* keyword @SHOPTYPE = not optional !!!
* keyword @WARRANTY = optional
* record 1 product-group = not optional !!!
* record 1 product-title = not optional !!!
* record 1 product-sellprice = not optional !!!
* record 1 product-description line 1 = not optional !!!
* record 1 product-description line 2 = optional
* record 1 product-description line 3 = optional
* record 1 product-description line 4 = optional
* record 1 product-description line 5 = optional
* record 1 product-description line 6 = optional
* record 1 product-description line 7 = optional
* record 1 product-description line 8 = optional
* record 1 product-description line 9 = optional
* record 1 product-description line 10 = optional
* record 1 product-description line 11 = optional
* record 1 product-description line 12 = optional
* keyword @BUY_PRICE1 = optional
* keyword @BUY_PRICE2 = optional
* keyword @BUY_PRICE3 = optional
* keyword @STORAGE = optional
* keyword @ (end of record 1 sign) = not optional !!!
* record 2 product-group = not optional !!!
* record 2 product-title = not optional !!!
* record 2 product-sellprice = not optional !!!
* record 2 product-description line 1 = not optional !!!
* record 2 product-description line n = optional
* record 2 product-description line 12 = optional
* keyword @BUY_PRICE1 = optional
* keyword @BUY_PRICE2 = optional
* keyword @BUY_PRICE3 = optional
* keyword @STORAGE = optional
* keyword @ (end of record 2 sign) = not optional !!!
- Keyword description '@SHOPTYPE='
This keyword is an exception to the other keywords,
it must be written on top of the text-file and you may
only use it once !!!
@SHOPTYPE=MEMO
──────────────
If you write 'MEMO' after this keyword, the ShopDoor will
display each record of this database in a memo-window on a maximum
of 12 lines under each other. A memo-window is maximum 12 lines long
and gives the BBS-user the possibility to look at all the
database-records using keys. You will see a maximum of 1 record each time,
but it's also possible to see the other records by just running
through the database. The format of a memo is predefined, the exact
format and the screen-positions are shown in the example-screen
called 'DBF001.ANS'. With each record you write 1 product-description
line as a minimum, but you may use a maximum of 12 product-description
lines ! Each product-description line may contain a maximum of 56
characters.
The keys which can be used by the BBS-user, for the memo-type,
running through the database are:
╓────────────┬────────────────────────────────────────────╖
║ Key │ Function ║
╟────────────┼────────────────────────────────────────────╢
║ P │ Go to the previous record of the database ║
║ N │ Go to the next record of the database ║
║ ESC │ Leave database-screen ║
║ + │ Order current article ║
╙────────────┴────────────────────────────────────────────╜
@SHOPTYPE=PICKLIST
──────────────────
If you write in 'PICKLIST' after this keyword, the ShopDoor will
display each record of this database on 1 line in a picklist-window.
A picklist-window is maximum 12 lines long and gives the BBS-user
the possibility to look at all the database-records using keys.
You will see a maximum of 12 records each time,
but it's also possible to see the other records by just running
through the database. The format of a picklist is predefined, the exact
format and the screen-positions you can see in the example-screen called
'DBF002.ANS'. With each record you must write 1 product-description
line and you may use 1 product-description line only !
The product-description line may contain a maximum of 56 characters.
The keys which can be used by the BBS-user, for the picklist-type,
running through the database are:
╓────────────┬────────────────────────────────────────────╖
║ Key │ Function ║
╟────────────┼────────────────────────────────────────────╢
║ 7-HOME │ Go to the beginning of the database ║
║ 1-END │ Go to the end of the database ║
║ 8-UP │ Go to a previous record of the database ║
║ 2-DOWN │ Go to a next record of the database ║
║ 9-PAGEUP │ Go one page back of the database ║
║ 3-PAGEDOWN │ Go one page further of the database ║
║ ESC │ Leave database-screen ║
║ + │ Order current article ║
╙────────────┴────────────────────────────────────────────╜
- Keyword description '@TAX=' (optional)
This a global keyword for entering taxes for various
products in de database. After the keyword we write the tax-percentage
in numbers, a maximum of 2 numbers before and 2 after the decimal point.
An example:
'@TAX=17.5' shows a tax-rate of 17.5%
- Keyword description '@VALUTA=' (optional)
This is a global keyword for entering the used valuta for the
products in the database. After the keyword we write the valuta-symbol
in a maximum of 4 text-characters. An example:
'@VALUTA=$' shows that we are using US-Dollars as valuta.
- Keyword description '@WARRANTY=' (optional)
This is a global keyword for entering the warranty-period
for the products in the database. After the keyword we write the
warranty-period in a maximum of 3 numbers.
An example:
'@WARRANTY=36' shows a warranty-period of 36 months.
- Keyword description '@BUY_PRICE1=','@BUY_PRICE2=' & '@BUY_PRICE3='
(optional) These keywords are local and identical.
With these, you can fill in the various buying-prices of each
product in the database. After the keyword we write the salesprice
in numbers, a maximum of 9 numbers before and 2 after the decimal point.
An example:
'@BUY_PRICE1=126.75' shows that the 1st buying-price is 126.75
'@BUY_PRICE2=123.35' shows that the 2nd buying-price is 123.35
'@BUY_PRICE3=125.95' shows that the 3th buying-price is 125.95
- Keyword description '@STORAGE=' (optional)
This is a local keyword for entering the amount of a product in
the database. After the keyword we write, in a maximum of 10 numbers,
the amount of products on stock. An example:
'@STORAGE=256' shows that 256 items of a type of product are on stock.
- Product-group
The product-group must be filled in, it's e.g. nescessary for the
pricelist-generator of the ShopManager !
It can exist of a maximum of 20 text-characters. For example,
your product is a CD-ROM, you fill in 'CD-ROM' as the product-group.
- Product-title
The product-title must be filled in, it's e.g. nescessary for the
pricelist-generator of the ShopManager !
It can exist of a maximum of 80 text-characters.
For example, your product is a CD-ROM, you fill in
'The newest MultiMedia-Software on CD-ROM !!!' as the product-title.
Last we will take a look at a small database text-file,
for better explanation we have put in linenumbers for each line:
01) @TAX=17.5
02) @VALUTA=$
03) @SHOPTYPE=MEMO
04) AZTEC
05) Hilltop Aztec VesaLocalbus Systems Pentium P24T upgradable
06) 2499.00
07) Mainboard 486SX 33MHz
08) RAM 4Mb
09) Harddisk 212Mb WD Caviar
10) Videocard 1Mb ALI Localbus
11) 3,5" 1,44Mb Floppydrive; SVGA Colormonitor 1024*768;
12) MTek Waterresistant keyboard; 486DX with CPU cooler
13) Multi I/O: 2Ser/1Par/1Game/2FDD/2HDD-Vesa Localbus
14) @WARRANTY=24
15) @STORAGE=5
16) @BUY_PRICE1=0.00
17) @BUY_PRICE2=0.00
18) @BUY_PRICE3=0.00
19) @
20) AZTEC
21) Hilltop Aztec VesaLocalbus Systems Pentium P24T upgradable
22) 2749.00
23) Mainboard 486DX 40MHz
24) RAM 4Mb
25) Harddisk 212Mb WD Caviar
26) Videocard 1Mb ALI Localbus
27) 3,5" 1,44Mb Floppydrive; SVGA Colormonitor 1024*768;
28) MTek Waterresistant keyboard; 486DX with CPU cooler
29) Multi I/O: 2Ser/1Par/1Game/2FDD/2HDD-Vesa Localbus
30) @
It's quite simple, line 1 til 3 will be clear enough.
The 1st record begins on line 4 and is closed on line 19.
The 2nd record begins on line 20 and is closed also on line 30.
Try it yourself if you understand the above example with
the help of this manual.
Creating a Pricelist
────────────────────
With the ShopManager you can create a nice pricelist.
The pricelist-generator gets all the data of your ShopDoor-Databases
and create a pricelist-file called 'SHOPLST.TXT'.
You can compress the file with your own 'ARJ-program' in
a file called 'SHOPLST.ARJ'.
The Order-Menu System
═════════════════════
The ShopDoor has a special Order-Menu in the Mainmenu.
There are 2 ways to order something using this menu.
1) Sending a order-message to the firm is the simple way.
2) If you use the ShopDoor database-functions, the user can order
the articles he want by selecting them with a key.
In the Order-Menu he can fill in his personal information,
his payment-method and his transfer-method.
He can take a look and/or download his bill also.
Of course is it possible for the user to cancel or to confirm is order.
When a user confirmed his order, the bill will be placed in the
ShopDoor Echomail-Board as a message to the firm automaticcaly.
The bill will be written on your harddisk with a unique filename
and extension '.ORD'. The bill can be print out for example.
Creating a Bill
───────────────
You can give a bill your own 'look' using 2 text-files.
We use the file: 'HEADER.TXT' for the start of the bill.
We use the file: 'FOOTER.TXT' for the end of the bill.
In these text-files we can write firm-text but also the
bill-informations using code-words. Underneath follows a
table with those code-words, a explanation and where it can
be used. You can find these 2 text-files in the demo-archive.
It will make things quite clear by looking at these files !
┌────────────────────────┬────────────────────┬─────────────────┐
│ Information │ Code-word │ Can be used in │
├────────────────────────┼────────────────────┼─────────────────┤
│ Date │ @DATE@ │ HEADER.TXT │
│ Name │ @NAME@ │ HEADER.TXT │
│ Clientnumber │ @CLIENTNO@ │ HEADER.TXT │
│ Address │ @ADDRESS1@ │ HEADER.TXT │
│ Zipcode │ @ADDRESS2@ │ HEADER.TXT │
│ Location │ @PLACE@ │ HEADER.TXT │
│ Country │ @ADDRESS3@ │ HEADER.TXT │
│ Voice Phone │ @VOICE@ │ HEADER.TXT │
│ Data Phone │ @DATA@ │ HEADER.TXT │
│ Fax Phone │ @FAX@ │ HEADER.TXT │
│ Nodenumber(s) │ @NODE@ │ HEADER.TXT │
│ Shipment Method │ @SHIPMENT@ │ HEADER.TXT │
│ Payment Method │ @PAYMENT@ │ HEADER.TXT │
│ CreditCard Number │ @CARDNO@ │ HEADER.TXT │
│ CreditCard Exp.Date │ @EXPDATE@ │ HEADER.TXT │
│ Total Costs bill │ @TOTAL@ │ FOOTER.TXT │
└────────────────────────┴────────────────────┴─────────────────┘
These files are coming with the ShopDoor-package
════════════════════════════════════════════════════════════════════════════
1) README.?? : A text-file with the latest news...
(NL = Netherlands, UK = English, D = German)
2) SHOP.EXE : The ShopDoor for the BBS,
execute it with a RA-menu type 7.
Define for example in your mainmenu
the following:
Action = Execute sub-program (Type 7)
Optdata = D:\RA\SHOPDOOR\SHOP.EXE *M
Use *M when you want to use a external editor
in your ShopDoor.
3) SHOPMGR.EXE : The ShopManager used for the ShopDoor.
4) SHOP.LOG : Will be made automatically: the logfile from the Door,
all actions off the users will be written in it.
5) SHOP.CFG : Will be made automatically: the cfgfile from the Door,
here you can simply put in your key eg. with an easy editor.
Explaination you will find in this file.
6) SHOP.CTL : Will be created by the ShopManager:
the operation-file where the ShopDoor works at.
7) SHOP.?? : This text-file in the languages:
(NL = Netherlands, UK = English, D = German, SP = Spanish).
8) EXAMPLE1.ARJ : An example from an installed ShopDoor,
unpack the file 'EXAMPLE1.ARJ' in the same
directory were you have put the package.
And go and try the ShopDoor and the ShopManager !
(the RIP-files must be placed in the RA-txtfiles directory !!!)
9) SHOP??.ARJ : Language Archive-files.
10) REGISTER.EXE : Registration-program.
Language-selection
══════════════════
With this package 4 languages are available:
Dutch, English, German and Spanish.
To select a language just choose the right archive-file and unpack it.
Dutch: 'SHOPNL.ARJ'.
English: 'SHOPUK.ARJ'.
German: 'SHOPD.ARJ'.
Spanish: 'SHOPSP.ARJ'.
Note
════
The author and distributers of the software-package 'ShopDoor'
can't be in any way made responsable for any damage in any form,
orginated from the use of the 'ShopDoor'.
SHOPDOOR can be used by everyone, but at his own risk !
Registration
════════════
The ShopDoor and the ShopManager can only be used fully
if you registrate the package.
There are a few registration-possibilities:
* A 1-key registration costs: HFL 75,= (Dutch Guilders)
* A 6-key registration costs: HFL 120,= (Dutch Guilders)
* A 20-key registration costs: HFL 275,= (Dutch Guilders)
* A 40-key registration costs: HFL 450,= (Dutch Guilders)
* Any extra key costs HFL 15,= (Dutch Guilders)
After your registration you will receive a keyfile for
the ShopManager and a key for the ShopDoor for your own BBS.
When you have a 6,20 or 40-key registration, you also have the possibility
to receive 5,19 or 39 more ShopDoor-keys for different BBS-systems,
extendable with the same ShopDoor and info-screens.
You will receive these keys on request from A.S. Kerkmeester,
after completing the form shown below.
Without the registration the program will only work as a demo !
The unregistrated ShopDoor-user has the following restrictions:
- The ShopDoor-functions 'download pricelist', 'place order',
'place message' and the 'statistics-generations' doesn't work.
- It's not possible to change the menu-structure with the ShopManager.
- The ShopDoor displays only a maximum of 30 database-records
at a database-screen.
The costs (see above), to pay at:
PostGiro 5312558
A.S. Kerkmeester
Hanzestraat 37
4527GH - Aardenburg
The Netherlands
Mentioning 'Registration ShopDoor'.
Of course you may also sending a Eurocheque to me !
After receiving the registration-money and after completing
(and sending) the form, the keys will be sent to you.
Please send the form to the Techno Support BBS by netmail.
For all your questions contact 1 of our named Distribution-Sites.
Many thanks to out betatesters-team:
═══════════════════════════════════════════════════════════════════════════
Ettie Kerkmeester (The Netherlands) : For checking the manuals...
Sergio Creimer (Brazil) : For beta-testing...
Thonie Weststrate (The Netherlands) : For beta-testing...
Mike Foedisch (Germany) : For beta-testing and translations...
Frank Durstewitz (Germany) : For beta-testing and translations...
Laurent Grinsven (The Netherlands) : For beta-testing...
Louis Gelderman (The Netherlands) : For beta-testing...
Rieks van Dijk (The Netherlands) : For beta-testing...
Sikko de Graaf (The Netherlands) : For beta-testing and creating the
nice RIP-Screens of the ShopDoor !!!
******************************************************************************
Registration-form for the software-package 'ShopDoor'
******************************************************************************
Name :
Adress :
Zipcode :
City :
Manager/Sysop :
BBS-name :
Phone voice :
Phone BBS :
Mail adresses :
Optional
------------------------------------------------------------------------------
Sysop (1) :
BBS-name (1) :
Phone voice (1) :
Phone BBS (1) :
Mail adresses (1) :
------------------------------------------------------------------------------
Sysop (2) :
BBS-name (2) :
Phone voice (2) :
Phone BBS (2) :
Mail adresses (2) :
------------------------------------------------------------------------------
Sysop (3) :
BBS-name (3) :
Phone voice (3) :
Phone BBS (3) :
Mail adresses (3) :
------------------------------------------------------------------------------
Sysop (4) :
BBS-name (4) :
Phone voice (4) :
Phone BBS (4) :
Mail adresses (4) :
------------------------------------------------------------------------------
Sysop (n) :
BBS-name (n) :
Phone voice (n) :
Phone BBS (n) :
Mail adresses (n) :
******************************************************************************
(ShopDoor runs only with Remote Access version 2.00 and higher)